home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Communication / MacWebLint-1.013 / README < prev   
Text File  |  1996-01-01  |  4KB  |  108 lines
  1.  
  2.               Weblint, Version 1.013
  3.  
  4.     Copyright (c) 1994, 1995, 1996 Neil Bowers.  All rights reserved.
  5.                            Khoral Research, Inc.
  6.  
  7.     This program is free software; you can redistribute it and/or modify
  8.     it under the terms of the "Artistic License".  You should have received
  9.     a copy of the Artistic License with this distribution, in the file named
  10.     "Artistic".  If not, I'll be glad to provide one.
  11.  
  12. --------------------------------------------------------------------------
  13.  
  14. Weblint is a syntax and minimal style checker for HTML: a perl script which
  15. picks fluff off html pages, much in the same way traditional lint picks fluff
  16. off C programs.  Files to be checked are passed on the command-line:
  17.  
  18.     % weblint *.html
  19.  
  20. Warnings are generated a la lint -- <filename>(line #): <warning>. E.g.:
  21.  
  22.     home.html(9): unmatched </H2> (seems to match <H1> on line 8)
  23.  
  24. The following checks are currently performed:
  25.  
  26.     *    basic structure
  27.     *    unknown elements and element attributes.
  28.     *    context checks (where a tag must appear within a certain element).
  29.     *    overlapped elements.
  30.     *    expects to see a TITLE in the HEAD element.
  31.     *    do IMG elements have ALT text?
  32.     *    illegally nested elements.
  33.     *    mis-matched tags (e.g., <H1> ... </H2>)
  34.     *    unclosed elements (e.g., <H1> ... )
  35.     *    catches elements which should only appear once
  36.     *    flags obsolete elements.
  37.     *    odd number of quotes in tag.
  38.     *    order of headings.
  39.     *    potentially unclosed tags.
  40.     *    flags markup embedded in comments --- this can confuse some browsers.
  41.     *    whines if you use `here' as anchor text :-)
  42.     *    tags where attributes are expected (e.g. anchors).
  43.     *    existence of local anchor targets.
  44.     *    flag case of tags (not enabled by default).
  45.     *    expect a <LINK REV=MADE HREF=mailto:...> in HEAD element
  46.     (not enabled by default).
  47.     *    supports HTML 3 elements, such as TABLE, MATH, FIG and the rest.
  48.     *    leading and trailing whitespace in certain container elements (eg A).
  49.     *    optional support for the java APPLET and PARAM elements.
  50.  
  51. All warnings can be enabled or disabled, using a configuration file,
  52. $HOME/.weblintrc.  A sample configuration file, weblintrc, is included
  53. in the distribution.
  54.  
  55. --------------------------------------------------------------------------
  56.  
  57. Installation
  58.  
  59. A simple Makefile is provided, in which you may want to modify BINDIR
  60. and MANDIR, which specify where the weblint script and manpage should
  61. be installed.
  62.  
  63. Weblint uses the `newgetopt.pl' and `find.pl' libraries, which are part
  64. of the standard perl library, so this will hopefully not cause any problems.
  65. Please let me know if it does.
  66.  
  67. The manpage (weblint.1) should be installed in a directory where it
  68. will be picked up by man (e.g., /usr/local/man/man1 on our machines).
  69. A postscript version of the manpage (weblint.ps) is available at:
  70.     http://ftp.khoral.com/pub/weblint/weblint.ps
  71.  
  72. Weblint is available via anonymous ftp, either as a gzip'd tar file,
  73. or zip'd archive:
  74.     ftp://ftp.khoral.com/pub/weblint/weblint-1.013.tar.gz
  75.     ftp://ftp.khoral.com/pub/weblint/weblint.zip
  76. or you can get it from the weblint home page:
  77.     http://www.khoral.com/staff/neilb/weblint.html
  78.  
  79. The weblint distribution includes a simple regression testsuite.
  80. Run the testsuite with either of the following commands:
  81.  
  82.     % make test
  83.     % ./test.pl
  84.  
  85. If any of the tests fail, please mail the logfile (weblint-test.log) to me.
  86.  
  87. --------------------------------------------------------------------------
  88.  
  89. I hope you find this useful.  Comments, suggestions and bug reports are
  90. welcome, see my email address or home page, given below.  Sample html
  91. helps when tracking down problems.
  92.  
  93. I maintain two email lists:
  94.  
  95.     weblint-announce@khoral.com
  96.         Announcements for new versions of weblint.
  97.  
  98.     weblint-victims@khoral.com
  99.         Discussion related to weblint (such as what features
  100.         should be added), as well as announcements for new
  101.         versions of weblint, and pre-release testing.
  102.  
  103. Email me if you want to be added to either list.
  104.  
  105. Neil Bowers
  106. Khoral Research, Inc.
  107. <neilb@khoral.com>    http://www.khoral.com/staff/neilb/
  108.